---
title: Cursor Rules for Building Agents
description: Use .cursorrules to improve AI coding assistant suggestions when building agents with Agno
---

A [`.cursorrules`](https://docs.cursor.com/context/rules-for-ai) file teaches AI coding assistants (like Cursor, Windsurf) how to build better agents with Agno.

## What is .cursorrules?

`.cursorrules` is a configuration file that provides your AI coding assistant with instructions on how to generate specific code.
Agno's recommended `.cursorrules` file contains:
- Agno-specific patterns and best practices
- Correct parameter names and syntax
- Common mistakes to avoid
- When to use Agent vs Team vs Workflow

Think of it as a reference guide that helps your AI assistant build agents correctly with Agno.

## Why Use It?

Without `.cursorrules`, AI assistants might suggest:
- Wrong parameter names (like `agents=` instead of `members=` for Teams)
- Outdated patterns or incorrect syntax
- Performance anti-patterns (creating agents in loops)
- Non-existent methods or features

With `.cursorrules`, your AI will:
- Suggest correct Agno patterns automatically
- Follow performance best practices
- Use the right approach for your use case
- Catch common mistakes before you make them

## How to Use .cursorrules

Copy the Agno `.cursorrules` file to your project root:

```bash
# Download the .cursorrules file
curl -o .cursorrules https://raw.githubusercontent.com/agno-agi/agno/main/.cursorrules

# Or clone and copy
git clone https://github.com/agno-agi/agno.git
cp agno/.cursorrules /path/to/your/project/
```

Your AI assistant (Cursor, Windsurf, etc.) will automatically detect and use it.

<Card title="View .cursorrules on GitHub" icon="github" href="https://github.com/agno-agi/agno/blob/main/.cursorrules">
  View the full .cursorrules file for building agents with Agno
</Card>

## IDE Support

`.cursorrules` works with:
- **Cursor** - Automatic detection
- **Windsurf** - Native support
- **Other AI assistants** - Support may vary depending on integration

## Learn More

For detailed examples and patterns:

<CardGroup cols={2}>
  <Card title="Agent Examples" icon="code" href="/examples/concepts/agent">
    See complete agent examples
  </Card>
  
  <Card title="Agent Concepts" icon="book" href="/concepts/agents/overview">
    Learn agent fundamentals
  </Card>
  
  <Card title="Teams" icon="users" href="/concepts/teams/overview">
    Multi-agent coordination
  </Card>
  
  <Card title="Workflows" icon="workflow" href="/concepts/workflows/overview">
    Deterministic agent orchestration
  </Card>
</CardGroup>

<Note>
The `.cursorrules` file is focused on **building agents with Agno**. If you're contributing to the Agno framework itself, that will be covered separately.
</Note>
